<!DOCTYPE html>


<html lang="zh-CN">


<head>
  <meta charset="utf-8" />
    
  <meta name="description" content="迎着朝阳的博客" />
  
  <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1" />
  <title>
    4、Spring 表达式语言(SpEL) |  迎着朝阳
  </title>
  <meta name="generator" content="hexo-theme-ayer">
  
  <link rel="shortcut icon" href="https://dxysun.com/static/yan.png" />
  
  
<link rel="stylesheet" href="/dist/main.css">

  
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/Shen-Yu/cdn/css/remixicon.min.css">

  
<link rel="stylesheet" href="/css/custom.css">

  
  
<script src="https://cdn.jsdelivr.net/npm/pace-js@1.0.2/pace.min.js"></script>

  
  

  
<script>
var _hmt = _hmt || [];
(function() {
	var hm = document.createElement("script");
	hm.src = "https://hm.baidu.com/hm.js?aa994a8d65700b8835787dd39d079d7e";
	var s = document.getElementsByTagName("script")[0]; 
	s.parentNode.insertBefore(hm, s);
})();
</script>


</head>

</html>

<body>
  <div id="app">
    
      
    <main class="content on">
      <section class="outer">
  <article
  id="post-springForSpel"
  class="article article-type-post"
  itemscope
  itemprop="blogPost"
  data-scroll-reveal
>
  <div class="article-inner">
    
    <header class="article-header">
       
<h1 class="article-title sea-center" style="border-left:0" itemprop="name">
  4、Spring 表达式语言(SpEL)
</h1>
 

    </header>
     
    <div class="article-meta">
      <a href="/2020/12/13/springForSpel/" class="article-date">
  <time datetime="2020-12-13T08:36:31.000Z" itemprop="datePublished">2020-12-13</time>
</a> 
  <div class="article-category">
    <a class="article-category-link" href="/categories/springdocs/">spring官方文档</a>
  </div>
  
<div class="word_count">
    <span class="post-time">
        <span class="post-meta-item-icon">
            <i class="ri-quill-pen-line"></i>
            <span class="post-meta-item-text"> 字数统计:</span>
            <span class="post-count">8.4k</span>
        </span>
    </span>

    <span class="post-time">
        &nbsp; | &nbsp;
        <span class="post-meta-item-icon">
            <i class="ri-book-open-line"></i>
            <span class="post-meta-item-text"> 阅读时长≈</span>
            <span class="post-count">36 分钟</span>
        </span>
    </span>
</div>
 
    </div>
      
    <div class="tocbot"></div>




  
    <div class="article-entry" itemprop="articleBody">
       
  <p><a id="expressions"></a></p>
<a id="more"></a>


<h2 id="4-Spring-的表达式语言-SpEL"><a href="#4-Spring-的表达式语言-SpEL" class="headerlink" title="4. Spring 的表达式语言(SpEL)"></a><a href="#expressions"></a>4. Spring 的表达式语言(SpEL)</h2><p>Spring Expression Language（简称“SpEL”）是一种强大的表达式语言，支持在运行时查询和操作对象。语言语法类似于Unified EL，但提供了其他功能，最有名的是方法调用和基本字符串模板功能。</p>
<p>尽管还有其他几种Java表达式语言，例如OGNL, MVEL, and JBoss，但SpEL只是为了向Spring社区提供一种支持良好的表达式语言，开发者可以在所有用到Spring框架的产品中使用SpEL。 其语言特性是由使用Spring框架项目的需求所驱动的，包括基于Eclipse的Spring Tool Suite代码支持的需求。也就是说，SpEL基于一种抽象实现的技术API，允许在需要时集成其他表达式语言来实现功能。</p>
<p>虽然SpEL作为Spring产品组合中的表达式运算操作的基础，但它并不直接与Spring耦合，可以独立使用。要自包含，本章中的许多示例都使用SpEL，就像它是一种独立的表达式语言一样。 这时需要创建一些引导作用的基础实现类，，例如解释器。大多数Spring用户不需要处理这种基础实现类，只需将表达式字符串作为运算操作即可。SpEL典型用途的是集成到创建XML或基于注解的bean定义中， 例如<a href="#expressions-beandef">bean定义的表达式支持</a>。</p>
<p>本章介绍表达式语言的功能，API及其语言语法。在一些地方，<code>Inventor</code>和<code>Society</code> 类作为表达式运算操作的目标对象。这些类声明和用于填充它们的数据列在本章末尾。</p>
<p>表达式语言支持以下功能:</p>
<ul>
<li><p>文字表达</p>
</li>
<li><p>布尔和关系运算符</p>
</li>
<li><p>正则表达式</p>
</li>
<li><p>类表达式</p>
</li>
<li><p>访问属性，数组，list和maps</p>
</li>
<li><p>方法调用</p>
</li>
<li><p>关系运算符</p>
</li>
<li><p>声明</p>
</li>
<li><p>调用构造器</p>
</li>
<li><p>bean的引用</p>
</li>
<li><p>数组的构造</p>
</li>
<li><p>内嵌的list</p>
</li>
<li><p>内嵌的map</p>
</li>
<li><p>三元表达式</p>
</li>
<li><p>变量</p>
</li>
<li><p>用户自定义函数</p>
</li>
<li><p>集合映射</p>
</li>
<li><p>集合选择</p>
</li>
<li><p>模板表达式</p>
</li>
</ul>
<p><a id="expressions-evaluation"></a></p>
<h3 id="4-1-使用Spring表达式接口的表达式运算"><a href="#4-1-使用Spring表达式接口的表达式运算" class="headerlink" title="4.1. 使用Spring表达式接口的表达式运算"></a><a href="#expressions-evaluation"></a>4.1. 使用Spring表达式接口的表达式运算</h3><p>本节介绍SpEL接口及其表达式语言的简单使用。 完整的语言参考可以在<a href="#expressions-language-ref">语言参考</a>中找到。</p>
<p>以下代码介绍使用SpEL API运算操作文字字符串表达式<code>Hello World</code></p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();
Expression exp = parser.parseExpression(&quot;&apos;Hello World&apos;&quot;); (1)
String message = (String) exp.getValue();</code></pre><p><strong>(1)。</strong>变量的值为“Hello World”。 <code>&#39;Hello World&#39;</code>.</p>
<p>您最有可能使用的SpEL类和接口位于<code>org.springframework.expression</code>包及其子包中，例如<code>spel.support</code>。</p>
<p><code>ExpressionParser</code>接口负责解析表达式字符串。在前面的示例中，表达式字符串是由周围的单引号表示的字符串文字。接口<code>Expression</code>负责运算操作先前定义的表达式字符串. 当分别调用<code>parser.parseExpression</code>和<code>exp.getValue</code>时，可能抛出两个异常：<code>ParseException</code>和<code>EvaluationException</code>。</p>
<p>SpEL支持广泛的功能，例如调用方法，访问属性和调用构造函数。</p>
<p>在下面的方法调用示例中，我们在字符串文字上调用<code>concat</code> 方法:</p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();
Expression exp = parser.parseExpression(&quot;&apos;Hello World&apos;.concat(&apos;!&apos;)&quot;); (1)
String message = (String) exp.getValue();</code></pre><p><strong>(1)。</strong>变量现在的值为 ‘Hello World!’.</p>
<p>以下调用JavaBean属性的示例调用<code>String</code>属性<code>Bytes</code>property :</p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();

// invokes &apos;getBytes()&apos;
Expression exp = parser.parseExpression(&quot;&apos;Hello World&apos;.bytes&quot;); (1)
byte[] bytes = (byte[]) exp.getValue();</code></pre><p><strong>(1)。</strong>该行将文字转换为字节数组。</p>
<p>SpEL还支持嵌套属性，使用标准的点符号。即<code>prop1.prop2.prop3</code>链式写法和设置属性值。也可以访问公共字段。 以下示例显示如何使用点表示法来获取文字的长度：</p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();

// invokes &apos;getBytes().length&apos;
Expression exp = parser.parseExpression(&quot;&apos;Hello World&apos;.bytes.length&quot;); (1)
int length = (Integer) exp.getValue();</code></pre><p><strong>(1)。</strong><code>&#39;Hello World&#39;.bytes.length</code> 给出了字符串的长度。</p>
<p>可以调用String的构造函数而不是使用字符串文字，如以下示例所示：</p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();
Expression exp = parser.parseExpression(&quot;new String(&apos;hello world&apos;).toUpperCase()&quot;); (1)
String message = exp.getValue(String.class);</code></pre><p><strong>(1)。</strong>从构造一个新的<code>String</code>对象并使其成为大写。</p>
<p>请注意泛型方法的使用: <code>public &lt;T&gt; T getValue(Class&lt;T&gt; desiredResultType)</code>。使用此方法不需要将表达式的值转换为所需的结果类型。如果该值不能转换为类型<code>T</code>或使用注册的类型转换器转换， 则将抛出<code>EvaluationException</code>异常。</p>
<p>SpEL的更常见用法是提供针对特定对象实例（称为根对象）计算的表达式字符串。 以下示例显示如何从<code>Inventor</code>类的实例检索<code>name</code>属性或创建布尔条件：</p>
<pre><code>// Create and set a calendar
GregorianCalendar c = new GregorianCalendar();
c.set(1856, 7, 9);

// The constructor arguments are name, birthday, and nationality.
Inventor tesla = new Inventor(&quot;Nikola Tesla&quot;, c.getTime(), &quot;Serbian&quot;);

ExpressionParser parser = new SpelExpressionParser();

Expression exp = parser.parseExpression(&quot;name&quot;); (1)
String name = (String) exp.getValue(tesla);
// name == &quot;Nikola Tesla&quot;

exp = parser.parseExpression(&quot;name == &apos;Nikola Tesla&apos;&quot;);
boolean result = exp.getValue(tesla, Boolean.class);
// result == true</code></pre><p><strong>(1)。</strong>将<code>name</code>解析为表达式。</p>
<p><a id="expressions-evaluation-context"></a></p>
<h4 id="4-1-1-了解-EvaluationContext"><a href="#4-1-1-了解-EvaluationContext" class="headerlink" title="4.1.1. 了解 EvaluationContext"></a><a href="#expressions-evaluation-context"></a>4.1.1. 了解 <code>EvaluationContext</code></h4><p>在评估表达式以解析属性，方法或字段以及帮助执行类型转换时，将使用<code>EvaluationContext</code>接口。 Spring提供了两种实现。</p>
<ul>
<li><p><code>SimpleEvaluationContext</code>: 为不需要SpEL语言语法的完整范围的表达式类别公开必要的SpEL语言特性和配置选项的子集， 并且应该进行有意义的限制。 示例包括但不限于数据绑定表达式和基于属性的过滤器。</p>
</li>
<li><p><code>StandardEvaluationContext</code>: 公开全套SpEL语言功能和配置选项。 您可以使用它来指定默认根对象并配置每个可用的与评估相关的策略。</p>
</li>
</ul>
<p><code>SimpleEvaluationContext</code> SimpleEvaluationContext旨在仅支持SpEL语言语法的子集。 它排除了Java类型引用，构造函数和bean引用。 它还要求您明确选择表达式中属性和方法的支持级别。 默认情况下，<code>create()</code> 静态工厂方法仅启用对属性的读访问权限。 您还可以获取构建器以配置所需的确切支持级别，定位以下一个或多个组合：</p>
<ul>
<li><p>仅限自定义 <code>PropertyAccessor</code>（无反射）</p>
</li>
<li><p>只读访问的数据绑定属性</p>
</li>
<li><p>读写的数据绑定属性</p>
</li>
</ul>
<p><a id="expressions-type-conversion"></a></p>
<h5 id="类型转换"><a href="#类型转换" class="headerlink" title="类型转换"></a><a href="#expressions-type-conversion"></a>类型转换</h5><p>默认情况下，SpEL使用Spring核心类(<code>org.springframework.core.convert.ConversionService</code>)提供的转换服务。此转换服务附带许多转换器，内置很多常用转换，但也支持扩展。 因此可以添加类型之间的自定义转换。此外，它具有泛型感知的关键功能。这意味着在使用表达式中的泛型类型时，SpEL将尝试转换以维护遇到的任何对象的类型正确性。</p>
<p>这在实践中能得到什么好处？假设使用<code>setValue()</code>的赋值被用于设置 <code>List</code>属性。属性的类型实际上是<code>List&lt;Boolean&gt;</code>，SpEL会识别列表的元素需要在被放置在其中之前被转换为布尔值。 以下示例显示了如何执行此操作：</p>
<pre><code>class Simple {
    public List&lt;Boolean&gt; booleanList = new ArrayList&lt;Boolean&gt;();
}

Simple simple = new Simple();
simple.booleanList.add(true);

EvaluationContext context = SimpleEvaluationContext().forReadOnlyDataBinding().build();

// false is passed in here as a string. SpEL and the conversion service
// correctly recognize that it needs to be a Boolean and convert it
parser.parseExpression(&quot;booleanList[0]&quot;).setValue(context, simple, &quot;false&quot;);

// b is false
Boolean b = simple.booleanList.get(0);</code></pre><p><a id="expressions-parser-configuration"></a></p>
<h4 id="4-1-2-解释器配置"><a href="#4-1-2-解释器配置" class="headerlink" title="4.1.2. 解释器配置"></a><a href="#expressions-parser-configuration"></a>4.1.2. 解释器配置</h4><p>可以使用解释器配置对象(<code>org.springframework.expression.spel.SpelParserConfiguration</code>)来配置SpEL表达式解释器。该配置对象控制表达式组件的行为。例如，如果索引到数组或集合，并且指定索引处的元素为null，则可以自动创建该元素。 当使用由一组属性引用组成的表达式时，这是非常有用的。如果创建数组或集合的索引，并指定了超出数组或列表的当前大小的结尾的索引时，它将自动增大数组或列表大小以适应索引。以下示例演示如何自动增长列表：</p>
<pre><code>class Demo {
    public List&lt;String&gt; list;
}

// Turn on:
// - auto null reference initialization
// - auto collection growing
SpelParserConfiguration config = new SpelParserConfiguration(true,true);

ExpressionParser parser = new SpelExpressionParser(config);

Expression expression = parser.parseExpression(&quot;list[3]&quot;);

Demo demo = new Demo();

Object o = expression.getValue(demo);

// demo.list will now be a real collection of 4 entries
// Each entry is a new empty String</code></pre><p><a id="expressions-spel-compilation"></a></p>
<h4 id="4-1-3-SpEL编译"><a href="#4-1-3-SpEL编译" class="headerlink" title="4.1.3. SpEL编译"></a><a href="#expressions-spel-compilation"></a>4.1.3. SpEL编译</h4><p>Spring Framework 4.1包含一个基本的表达式编译器。通常，由于表达式在操作过程中提供的大量动态性、灵活性的运算能够被解释，但不能保证提供最佳性能。对于不常使用的表达式使用这是非常好的， 但是当被其他并不真正需要动态灵活性的组件（例如Spring Integration）使用时，性能可能成为瓶颈。</p>
<p>新的SpEL编译器旨在满足这一需求。编译器将在表达行为运算操作期间即时生成一个真正的Java类，并使用它来实现更快的表达式求值。由于缺少对表达式按类型归类，编译器在执行编译时会使用在表达式解释运算期间收集的信息来编译。 例如，它不仅仅需要从表达式中知道属性引用的类型，而且需要在第一个解释运算过程中发现它是什么。当然，如果各种表达式元素的类型随着时间的推移而变化，那么基于此信息的编译可能会发生问题。因此， 编译最适合于重复运算操作而类型信息不会改变的表达式。</p>
<p>请考虑以下基本表达式:</p>
<p>someArray[0].someProperty.someOtherProperty &lt; 0.1</p>
<p>这涉及到数组访问，某些属性的取消和数字操作，所以性能增益非常明显。 在50000次迭代的微基准测试示例中，使用解释器评估需要75ms，使用表达式的编译版本只需3ms。</p>
<p><a id="expressions-compiler-configuration"></a></p>
<h5 id="编译器配置"><a href="#编译器配置" class="headerlink" title="编译器配置"></a><a href="#expressions-compiler-configuration"></a>编译器配置</h5><p>编译器在默认情况下是关闭的，有两种方法可以打开。您可以使用解析器配置过程（(<a href="#expressions-parser-configuration">前面讨论的</a>）或在将SpEL用法嵌入到另一个组件中时使用系统属性来打开它。 本节讨论这两个选项。</p>
<p>编译器可以以三种模式之一操作，这些模式在<code>org.springframework.expression.spel.SpelCompilerMode</code>枚举中获取。 模式如下：</p>
<ul>
<li><p><code>OFF</code> (default): 编译器已关闭。</p>
</li>
<li><p><code>IMMEDIATE</code>: 在即时模式下，表达式将尽快编译。这通常在第一次解释运算之后，如果编译的表达式失败（通常是由于类型更改引起的，参看上一节），则表达式运算操作的调用者将收到异常。</p>
</li>
<li><p><code>MIXED</code>:在混合模式下，表达式随着时间的推移在解释模式和编译模式之间静默地切换。经过一些解释运行后，它们将切换到编译模式，如果编译后的表单出现问题（如上所述改变类型）， 表达式将自动重新切换回解释模式。稍后，它可能生成另一个编译表单并切换。基本上，用户进入<code>IMMEDIATE</code>模式的异常是内部处理的。</p>
</li>
</ul>
<p>推荐<code>IMMEDIATE</code>即时模式，因为<code>MIXED</code>模式可能会导致副作用，使得表达式出错。如果编译的表达式在部分成功之后崩掉，此时可能已经影响了系统状态。 如果发生这种情况，调用者可能不希望它在解释模式下静默地重新运行，这样的话表达式的某部分可能会运行两次。</p>
<p>选择模式后，使用<code>SpelParserConfiguration</code>配置解析器。 以下示例显示了如何执行此操作：</p>
<pre><code>SpelParserConfiguration config = new SpelParserConfiguration(SpelCompilerMode.IMMEDIATE,
    this.getClass().getClassLoader());

SpelExpressionParser parser = new SpelExpressionParser(config);

Expression expr = parser.parseExpression(&quot;payload&quot;);

MyMessage message = new MyMessage();

Object payload = expr.getValue(message);</code></pre><p>指定编译器模式时，还可以指定类加载器（允许传递null）。编译表达式将在任何提供的子类加载器中被定义。重要的是确保是否指定了类加载器，它可以看到表达式运算操作过程中涉及的所有类型。 如果没有指定，那么将使用默认的类加载器（通常是在表达式计算期间运行的线程的上下文类加载器）。</p>
<p>配置编译器的第二种方法是将SpEL嵌入其他组件内部使用，并且可能无法通过配置对象进行配置。在这种情况下，可以使用系统属性配置。属性<code>spring.expression.compiler.mode</code> 可以设置为<code>SpelCompilerMode</code>枚举值之一（<code>off</code>, <code>immediate</code>, 或 <code>mixed</code>）。</p>
<p><a id="expressions-compiler-limitations"></a></p>
<h5 id="编译器限制"><a href="#编译器限制" class="headerlink" title="编译器限制"></a><a href="#expressions-compiler-limitations"></a>编译器限制</h5><p>从Spring Framework 4.1开始，基本编译框架已经存在。 但是，该框架尚不支持编译各种表达式。最初的重点是在可能在性能要求高的关键环境中使用的常见表达式。目前无法编译以下类型的表达式：</p>
<ul>
<li><p>涉及转让的表达</p>
</li>
<li><p>依赖转换服务的表达式</p>
</li>
<li><p>使用自定义解释器或访问器的表达式</p>
</li>
<li><p>使用选择或投影的表达式</p>
</li>
</ul>
<p>越来越多的类型的表达式将在未来可编译.</p>
<p><a id="expressions-beandef"></a></p>
<h3 id="4-2-bean定义的表达式支持"><a href="#4-2-bean定义的表达式支持" class="headerlink" title="4.2. bean定义的表达式支持"></a><a href="#expressions-beandef"></a>4.2. bean定义的表达式支持</h3><p>SpEL表达式可以通过XML或基于注解的配置用于定义<code>BeanDefinition</code>实例。在这两种情况下，定义表达式的语法是<code>#{ &lt;expression string&gt; }</code></p>
<p><a id="expressions-beandef-xml-based"></a></p>
<h4 id="4-2-1-XML-配置"><a href="#4-2-1-XML-配置" class="headerlink" title="4.2.1. XML 配置"></a><a href="#expressions-beandef-xml-based"></a>4.2.1. XML 配置</h4><p>可以使用表达式设置属性或构造函数参数值，如以下示例所示:</p>
<pre><code>&lt;bean id=&quot;numberGuess&quot; class=&quot;org.spring.samples.NumberGuess&quot;&gt;
    &lt;property name=&quot;randomNumber&quot; value=&quot;#{ T(java.lang.Math).random() * 100.0 }&quot;/&gt;

    &lt;!-- other properties --&gt;
&lt;/bean&gt;</code></pre><p><code>systemProperties</code> 变量是预定义的，因此您可以在表达式中使用它，如以下示例所示：</p>
<pre><code>&lt;bean id=&quot;taxCalculator&quot; class=&quot;org.spring.samples.TaxCalculator&quot;&gt;
    &lt;property name=&quot;defaultLocale&quot; value=&quot;#{ systemProperties[&apos;user.region&apos;] }&quot;/&gt;

    &lt;!-- other properties --&gt;
&lt;/bean&gt;</code></pre><p>请注意，您不必在此上下文中使用＃符号为预定义变量添加前缀。</p>
<p>您还可以按名称引用其他bean属性，如以下示例所示:</p>
<pre><code>&lt;bean id=&quot;numberGuess&quot; class=&quot;org.spring.samples.NumberGuess&quot;&gt;
    &lt;property name=&quot;randomNumber&quot; value=&quot;#{ T(java.lang.Math).random() * 100.0 }&quot;/&gt;

    &lt;!-- other properties --&gt;
&lt;/bean&gt;

&lt;bean id=&quot;shapeGuess&quot; class=&quot;org.spring.samples.ShapeGuess&quot;&gt;
    &lt;property name=&quot;initialShapeSeed&quot; value=&quot;#{ numberGuess.randomNumber }&quot;/&gt;

    &lt;!-- other properties --&gt;
&lt;/bean&gt;</code></pre><p><a id="expressions-beandef-annotation-based"></a></p>
<h4 id="4-2-2-注解-Configuration"><a href="#4-2-2-注解-Configuration" class="headerlink" title="4.2.2. 注解 Configuration"></a><a href="#expressions-beandef-annotation-based"></a>4.2.2. 注解 Configuration</h4><p>要指定默认值，可以在字段，方法和方法或构造函数参数上放置<code>@Value</code>注解。</p>
<p>以下示例设置字段变量的默认值:</p>
<pre><code>public static class FieldValueTestBean

    @Value(&quot;#{ systemProperties[&apos;user.region&apos;] }&quot;)
    private String defaultLocale;

    public void setDefaultLocale(String defaultLocale) {
        this.defaultLocale = defaultLocale;
    }

    public String getDefaultLocale() {
        return this.defaultLocale;
    }

}</code></pre><p>下面显示了属性setter方法的相同配置:</p>
<pre><code>public static class PropertyValueTestBean

    private String defaultLocale;

    @Value(&quot;#{ systemProperties[&apos;user.region&apos;] }&quot;)
    public void setDefaultLocale(String defaultLocale) {
        this.defaultLocale = defaultLocale;
    }

    public String getDefaultLocale() {
        return this.defaultLocale;
    }

}</code></pre><p>使用<code>@Autowired</code>方法注解的构造方法也可以使用<code>@Value</code>注解:</p>
<pre><code>public class SimpleMovieLister {

    private MovieFinder movieFinder;
    private String defaultLocale;

    @Autowired
    public void configure(MovieFinder movieFinder,
            @Value(&quot;#{ systemProperties[&apos;user.region&apos;] }&quot;) String defaultLocale) {
        this.movieFinder = movieFinder;
        this.defaultLocale = defaultLocale;
    }

    // ...
}

public class MovieRecommender {

    private String defaultLocale;

    private CustomerPreferenceDao customerPreferenceDao;

    @Autowired
    public MovieRecommender(CustomerPreferenceDao customerPreferenceDao,
            @Value(&quot;#{systemProperties[&apos;user.country&apos;]}&quot;) String defaultLocale) {
        this.customerPreferenceDao = customerPreferenceDao;
        this.defaultLocale = defaultLocale;
    }

    // ...
}</code></pre><p><a id="expressions-language-ref"></a></p>
<h3 id="4-3-语言引用"><a href="#4-3-语言引用" class="headerlink" title="4.3. 语言引用"></a><a href="#expressions-language-ref"></a>4.3. 语言引用</h3><p>本节介绍Spring表达式语言的工作原理。 它涵盖以下主题：</p>
<ul>
<li><p><a href="#expressions-ref-literal">文字表达</a></p>
</li>
<li><p><a href="#expressions-properties-arrays">属性，数组，list，maps和indexs</a></p>
</li>
<li><p><a href="#expressions-inline-lists">内嵌的list</a></p>
</li>
<li><p><a href="#expressions-inline-maps">内嵌的map</a></p>
</li>
<li><p><a href="#expressions-array-construction">数组的构造</a></p>
</li>
<li><p><a href="#expressions-methods">方法</a></p>
</li>
<li><p><a href="#expressions-operators">运算符</a></p>
</li>
<li><p><a href="#expressions-types">类型</a></p>
</li>
<li><p><a href="#expressions-constructors">构造器</a></p>
</li>
<li><p><a href="#expressions-ref-variables">变量</a></p>
</li>
<li><p><a href="#expressions-ref-functions">函数</a></p>
</li>
<li><p><a href="#expressions-bean-references">Bean 的引用</a></p>
</li>
<li><p><a href="#expressions-operator-ternary">三元运算符（If-Then-Else）</a></p>
</li>
<li><p><a href="#expressions-operator-elvis">Elvis运算符</a></p>
</li>
<li><p><a href="#expressions-operator-safe-navigation">安全的引导运算符</a></p>
</li>
</ul>
<p><a id="expressions-ref-literal"></a></p>
<h4 id="4-3-1-文字表达"><a href="#4-3-1-文字表达" class="headerlink" title="4.3.1. 文字表达"></a><a href="#expressions-ref-literal"></a>4.3.1. 文字表达</h4><p>支持的文字表达式的类型是字符串，数值（int，real，hex），boolean和null。 字符串由单引号分隔。 要在字符串中放置单引号，请使用两个单引号字符。</p>
<p>以下清单显示了文字的简单用法。 通常，它们不是像这样单独使用，而是作为更复杂表达式的一部分使用 - 例如，在逻辑比较运算符的一侧使用文字。</p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();

// evals to &quot;Hello World&quot;
String helloWorld = (String) parser.parseExpression(&quot;&apos;Hello World&apos;&quot;).getValue();

double avogadrosNumber = (Double) parser.parseExpression(&quot;6.0221415E+23&quot;).getValue();

// evals to 2147483647
int maxValue = (Integer) parser.parseExpression(&quot;0x7FFFFFFF&quot;).getValue();

boolean trueValue = (Boolean) parser.parseExpression(&quot;true&quot;).getValue();

Object nullValue = parser.parseExpression(&quot;null&quot;).getValue();</code></pre><p>数字支持使用负号，指数表示法和小数点。 默认情况下，使用<code>Double.parseDouble()</code>解析实数。.</p>
<p><a id="expressions-properties-arrays"></a></p>
<h4 id="4-3-2-Properties-Arrays-Lists-Maps-and-Indexers"><a href="#4-3-2-Properties-Arrays-Lists-Maps-and-Indexers" class="headerlink" title="4.3.2. Properties, Arrays, Lists, Maps, and Indexers"></a><a href="#expressions-properties-arrays"></a>4.3.2. Properties, Arrays, Lists, Maps, and Indexers</h4><p>调用属性的引用是很简单的,只要指定内置的属性值即可。<code>Inventor</code>类（<code>pupin</code> 和 <code>tesla</code>）的实例填充了<a href="#expressions-example-classes">示例</a>部分中使用的类中列出的数据。 下面的表达式用于获得Tesla的出生年和Pupin的出生城市:</p>
<pre><code>// evals to 1856
int year = (Integer) parser.parseExpression(&quot;Birthdate.Year + 1900&quot;).getValue(context);

String city = (String) parser.parseExpression(&quot;placeOfBirth.City&quot;).getValue(context);</code></pre><p>属性名称的第一个字母允许不区分大小写。 数组和列表的内容是使用方括号表示法获得的，如下例所示：:</p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();
EvaluationContext context = SimpleEvaluationContext.forReadOnlyDataBinding().build();

// Inventions Array

// evaluates to &quot;Induction motor&quot;
String invention = parser.parseExpression(&quot;inventions[3]&quot;).getValue(
        context, tesla, String.class);

// Members List

// evaluates to &quot;Nikola Tesla&quot;
String name = parser.parseExpression(&quot;Members[0].Name&quot;).getValue(
        context, ieee, String.class);

// List and Array navigation
// evaluates to &quot;Wireless communication&quot;
String invention = parser.parseExpression(&quot;Members[0].Inventions[6]&quot;).getValue(
        context, ieee, String.class);</code></pre><p>maps的内容通过方括号包着文字的键/值定义。在这种情况下， 由于 <code>Officers</code>的keys是字符串，则可以定义字符字面值：</p>
<pre><code>// Officer&apos;s Dictionary

Inventor pupin = parser.parseExpression(&quot;Officers[&apos;president&apos;]&quot;).getValue(
        societyContext, Inventor.class);

// evaluates to &quot;Idvor&quot;
String city = parser.parseExpression(&quot;Officers[&apos;president&apos;].PlaceOfBirth.City&quot;).getValue(
        societyContext, String.class);

// setting values
parser.parseExpression(&quot;Officers[&apos;advisors&apos;][0].PlaceOfBirth.Country&quot;).setValue(
        societyContext, &quot;Croatia&quot;);</code></pre><p><a id="expressions-inline-lists"></a></p>
<h4 id="4-3-3-内嵌的list"><a href="#4-3-3-内嵌的list" class="headerlink" title="4.3.3. 内嵌的list"></a><a href="#expressions-inline-lists"></a>4.3.3. 内嵌的list</h4><p>您可以使用<code>{}</code>表示法直接在表达式中表达列表。</p>
<pre><code>// evaluates to a Java list containing the four numbers
List numbers = (List) parser.parseExpression(&quot;{1,2,3,4}&quot;).getValue(context);

List listOfLists = (List) parser.parseExpression(&quot;{{'a','b'},{'x','y'}}&quot;).getValue(context);</code></pre><p><code>{}</code>本身就是一个空列表。 出于性能原因，如果列表本身完全由固定文字组成，则会创建一个常量列表来表示表达式（而不是在每个计算上构建新列表）。</p>
<p><a id="expressions-inline-maps"></a></p>
<h4 id="4-3-4-内嵌的map"><a href="#4-3-4-内嵌的map" class="headerlink" title="4.3.4. 内嵌的map"></a><a href="#expressions-inline-maps"></a>4.3.4. 内嵌的map</h4><p>您还可以使用<code>{key:value}</code>表示法直接在表达式中表达map。 以下示例显示了如何执行此操作：</p>
<pre><code>// evaluates to a Java map containing the two entries
Map inventorInfo = (Map) parser.parseExpression(&quot;{name:&apos;Nikola&apos;,dob:&apos;10-July-1856&apos;}&quot;).getValue(context);

Map mapOfMaps = (Map) parser.parseExpression(&quot;{name:{first:&apos;Nikola&apos;,last:&apos;Tesla&apos;},dob:{day:10,month:&apos;July&apos;,year:1856}}&quot;).getValue(context);</code></pre><p><code>{:}</code> {：}本身就是一张空map。 出于性能原因，如果map本身由固定文字或其他嵌套常量结构（列表或map）组成， 则会创建一个常量来表示表达式（而不是在每次计算时构建新map）。 map的双引号是可选的。 上面的示例没有使用双引号的key。</p>
<p><a id="expressions-array-construction"></a></p>
<h4 id="4-3-5-数组的构造"><a href="#4-3-5-数组的构造" class="headerlink" title="4.3.5. 数组的构造"></a><a href="#expressions-array-construction"></a>4.3.5. 数组的构造</h4><p>您可以使用熟悉的Java语法构建数组，可选择提供初始化程序以在构造时填充数组。 以下示例显示了如何执行此操作：:</p>
<pre><code>int[] numbers1 = (int[]) parser.parseExpression(&quot;new int[4]&quot;).getValue(context);

// Array with initializer
int[] numbers2 = (int[]) parser.parseExpression(&quot;new int[]{1,2,3}&quot;).getValue(context);

// Multi dimensional array
int[][] numbers3 = (int[][]) parser.parseExpression(&quot;new int[4][5]&quot;).getValue(context);</code></pre><p>目前不支持创建多维数组的初始化器。</p>
<p><a id="expressions-methods"></a></p>
<h4 id="4-3-6-方法"><a href="#4-3-6-方法" class="headerlink" title="4.3.6. 方法"></a><a href="#expressions-methods"></a>4.3.6. 方法</h4><p>方法是使用典型的Java编程语法调用的，还可以对文本调用方法。也支持对参数的调用。</p>
<pre><code>// string literal, evaluates to &quot;bc&quot;
String bc = parser.parseExpression(&quot;&apos;abc&apos;.substring(1, 3)&quot;).getValue(String.class);

// evaluates to true
boolean isMember = parser.parseExpression(&quot;isMember(&apos;Mihajlo Pupin&apos;)&quot;).getValue(
        societyContext, Boolean.class);</code></pre><p><a id="expressions-operators"></a></p>
<h4 id="4-3-7-运算符"><a href="#4-3-7-运算符" class="headerlink" title="4.3.7. 运算符"></a><a href="#expressions-operators"></a>4.3.7. 运算符</h4><p>Spring Expression Language支持以下类型的运算符：</p>
<ul>
<li><p><a href="#expressions-operators-relational">关系运算符</a></p>
</li>
<li><p><a href="#expressions-operators-logical">逻辑运算符</a></p>
</li>
<li><p><a href="#expressions-operators-mathematical">数学运算符</a></p>
</li>
<li><p><a href="#expressions-assignment">赋值运算符</a></p>
</li>
</ul>
<p><a id="expressions-operators-relational"></a></p>
<h5 id="关系运算符"><a href="#关系运算符" class="headerlink" title="关系运算符"></a><a href="#expressions-operators-relational"></a>关系运算符</h5><p>使用标准运算符表示法支持关系运算符（等于，不等于，小于，小于或等于，大于，等于或等于）。 以下清单显示了一些运算符示例：</p>
<pre><code>// evaluates to true
boolean trueValue = parser.parseExpression(&quot;2 == 2&quot;).getValue(Boolean.class);

// evaluates to false
boolean falseValue = parser.parseExpression(&quot;2 &lt; -5.0&quot;).getValue(Boolean.class);

// evaluates to true
boolean trueValue = parser.parseExpression(&quot;&apos;black&apos; &lt; &apos;block&apos;&quot;).getValue(Boolean.class);</code></pre><p>大于和小于<code>null</code>的比较遵循一个简单的规则：<code>null</code>被视为空（不是零）。 因此，任何其他值始终大于<code>null</code>（<code>X &gt; null</code>始终为<code>true</code>），并且其他任何值都不会小于任何值（<code>X &lt; null</code> 始终为<code>false</code>）。</p>
<p>如果您更喜欢数字比较，请避免基于数字的<code>null</code>比较，以支持与零进行比较（例如， <code>X &gt; 0</code>或 <code>X &lt; 0</code>）。</p>
<p>除了标准的关系运算符之外，SpEL支持<code>instanceof</code>和基于<code>matches</code>的正则表达式运算符，以下列表显示了两者的示例:</p>
<pre><code>// evaluates to false
boolean falseValue = parser.parseExpression(
        &quot;&apos;xyz&apos; instanceof T(Integer)&quot;).getValue(Boolean.class);

// evaluates to true
boolean trueValue = parser.parseExpression(
        &quot;&apos;5.00&apos; matches &apos;^-?\\d+(\\.\\d{2})?$&apos;&quot;).getValue(Boolean.class);

//evaluates to false
boolean falseValue = parser.parseExpression(
        &quot;&apos;5.0067&apos; matches &apos;^-?\\d+(\\.\\d{2})?$&apos;&quot;).getValue(Boolean.class);</code></pre><p>使用原始类型的时候留意他们会直接被包装成包装类，因此 <code>1 instanceof T(int)</code>是<code>false</code>。而<code>1 instanceof T(Integer)</code>是<code>true</code>。</p>
<p>每一个符号运算符可以使用直接的单词字母（前缀）来定义，这样可以避免在某些特定的表达式会在文件类型中出现问题（例如XML文档）。现在列出文本的替换规则：</p>
<ul>
<li><p><code>lt</code> (<code>&lt;</code>)</p>
</li>
<li><p><code>gt</code> (<code>&gt;</code>)</p>
</li>
<li><p><code>le</code> (<code>&lt;=</code>)</p>
</li>
<li><p><code>ge</code> (<code>&gt;=</code>)</p>
</li>
<li><p><code>eq</code> (<code>==</code>)</p>
</li>
<li><p><code>ne</code> (<code>!=</code>)</p>
</li>
<li><p><code>div</code> (<code>/</code>)</p>
</li>
<li><p><code>mod</code> (<code>%</code>)</p>
</li>
<li><p><code>not</code> (<code>!</code>).</p>
</li>
</ul>
<p>所有文本运算符都不区分大小写。.</p>
<p><a id="expressions-operators-logical"></a></p>
<h5 id="逻辑运算符"><a href="#逻辑运算符" class="headerlink" title="逻辑运算符"></a><a href="#expressions-operators-logical"></a>逻辑运算符</h5><p>SpEL支持以下逻辑运算符：</p>
<ul>
<li><p><code>and</code></p>
</li>
<li><p><code>or</code></p>
</li>
<li><p><code>not</code></p>
</li>
</ul>
<p>以下示例显示如何使用逻辑运算符</p>
<pre><code>// -- AND --

// evaluates to false
boolean falseValue = parser.parseExpression(&quot;true and false&quot;).getValue(Boolean.class);

// evaluates to true
String expression = &quot;isMember(&apos;Nikola Tesla&apos;) and isMember(&apos;Mihajlo Pupin&apos;)&quot;;
boolean trueValue = parser.parseExpression(expression).getValue(societyContext, Boolean.class);

// -- OR --

// evaluates to true
boolean trueValue = parser.parseExpression(&quot;true or false&quot;).getValue(Boolean.class);

// evaluates to true
String expression = &quot;isMember(&apos;Nikola Tesla&apos;) or isMember(&apos;Albert Einstein&apos;)&quot;;
boolean trueValue = parser.parseExpression(expression).getValue(societyContext, Boolean.class);

// -- NOT --

// evaluates to false
boolean falseValue = parser.parseExpression(&quot;!true&quot;).getValue(Boolean.class);

// -- AND and NOT --
String expression = &quot;isMember(&apos;Nikola Tesla&apos;) and !isMember(&apos;Mihajlo Pupin&apos;)&quot;;
boolean falseValue = parser.parseExpression(expression).getValue(societyContext, Boolean.class);</code></pre><p><a id="expressions-operators-mathematical"></a></p>
<h5 id="数学运算符"><a href="#数学运算符" class="headerlink" title="数学运算符"></a><a href="#expressions-operators-mathematical"></a>数学运算符</h5><p>加法可以用在数值和字符串之间。减法、乘法和除法只能用在数值上。其他算术运算符支持取余和乘方。标准的运算符是支持优先级的。以下示例显示了正在使用的数学运算符：</p>
<pre><code>// Addition
int two = parser.parseExpression(&quot;1 + 1&quot;).getValue(Integer.class);  // 2

String testString = parser.parseExpression(
        &quot;&apos;test&apos; + &apos; &apos; + &apos;string&apos;&quot;).getValue(String.class);  // &apos;test string&apos;

// Subtraction
int four = parser.parseExpression(&quot;1 - -3&quot;).getValue(Integer.class);  // 4

double d = parser.parseExpression(&quot;1000.00 - 1e4&quot;).getValue(Double.class);  // -9000

// Multiplication
int six = parser.parseExpression(&quot;-2 * -3&quot;).getValue(Integer.class);  // 6

double twentyFour = parser.parseExpression(&quot;2.0 * 3e0 * 4&quot;).getValue(Double.class);  // 24.0

// Division
int minusTwo = parser.parseExpression(&quot;6 / -3&quot;).getValue(Integer.class);  // -2

double one = parser.parseExpression(&quot;8.0 / 4e0 / 2&quot;).getValue(Double.class);  // 1.0

// Modulus
int three = parser.parseExpression(&quot;7 % 4&quot;).getValue(Integer.class);  // 3

int one = parser.parseExpression(&quot;8 / 5 % 2&quot;).getValue(Integer.class);  // 1

// Operator precedence
int minusTwentyOne = parser.parseExpression(&quot;1+2-3*8&quot;).getValue(Integer.class);  // -21</code></pre><p><a id="expressions-assignment"></a></p>
<h5 id="赋值运算符"><a href="#赋值运算符" class="headerlink" title="赋值运算符"></a><a href="#expressions-assignment"></a>赋值运算符</h5><p>要设置属性，请使用赋值运算符(<code>=</code>)。 这通常在调用<code>setValue</code>时完成，但也可以在调用<code>getValue</code>时完成。 以下清单显示了使用赋值运算符的两种方法:</p>
<pre><code>Inventor inventor = new Inventor();
EvaluationContext context = SimpleEvaluationContext.forReadWriteDataBinding().build();

parser.parseExpression(&quot;Name&quot;).setValue(context, inventor, &quot;Aleksandar Seovic&quot;);

// alternatively
String aleks = parser.parseExpression(
        &quot;Name = &apos;Aleksandar Seovic&apos;&quot;).getValue(context, inventor, String.class);</code></pre><p><a id="expressions-types"></a></p>
<h4 id="4-3-8-类型"><a href="#4-3-8-类型" class="headerlink" title="4.3.8. 类型"></a><a href="#expressions-types"></a>4.3.8. 类型</h4><p>特殊<code>T</code>运算符可用于指定<code>java.lang.Class</code>的实例(类型)。也可以使用此运算符调用静态方法。<code>StandardEvaluationContext</code>使用<code>TypeLocator</code>来查找类型， 而<code>StandardTypeLocator</code>(可以替换)是通过对<code>java.lang</code>包的解释而生成的。这意味着 <code>T()</code>对<code>java.lang</code>中的类型的引用不需要完全限定，但所有其他类型引用都是必须的。 以下示例显示如何使用<code>T</code>运算符:</p>
<pre><code>Class dateClass = parser.parseExpression(&quot;T(java.util.Date)&quot;).getValue(Class.class);

Class stringClass = parser.parseExpression(&quot;T(String)&quot;).getValue(Class.class);

boolean trueValue = parser.parseExpression(
        &quot;T(java.math.RoundingMode).CEILING &lt; T(java.math.RoundingMode).FLOOR&quot;)
        .getValue(Boolean.class);</code></pre><p><a id="expressions-constructors"></a></p>
<h4 id="4-3-9-构造器"><a href="#4-3-9-构造器" class="headerlink" title="4.3.9. 构造器"></a><a href="#expressions-constructors"></a>4.3.9. 构造器</h4><p>可以使用<code>new</code>运算符调用构造函数。除了基本类型和String外需要使用全限定类名 (<code>int</code>, <code>float</code>,等等是可以直接使用的)。 以下示例显示如何使用 <code>new</code>运算符来调用构造函数：</p>
<pre><code>Inventor einstein = p.parseExpression(
        &quot;new org.spring.samples.spel.inventor.Inventor(&apos;Albert Einstein&apos;, &apos;German&apos;)&quot;)
        .getValue(Inventor.class);

//create new inventor instance within add method of List
p.parseExpression(
        &quot;Members.add(new org.spring.samples.spel.inventor.Inventor(
            &apos;Albert Einstein&apos;, &apos;German&apos;))&quot;).getValue(societyContext);</code></pre><p><a id="expressions-ref-variables"></a></p>
<h4 id="4-3-10-变量"><a href="#4-3-10-变量" class="headerlink" title="4.3.10. 变量"></a><a href="#expressions-ref-variables"></a>4.3.10. 变量</h4><p>在表达式中，变量通过<code>#variableName</code> 模式来表示。变量的设置用到<code>EvaluationContext</code>的<code>setVariable</code>方法。<code>setVariable</code></p>
<pre><code>Inventor tesla = new Inventor(&quot;Nikola Tesla&quot;, &quot;Serbian&quot;);

EvaluationContext context = SimpleEvaluationContext.forReadWriteDataBinding().build();
context.setVariable(&quot;newName&quot;, &quot;Mike Tesla&quot;);

parser.parseExpression(&quot;Name = #newName&quot;).getValue(context, tesla);
System.out.println(tesla.getName())  // &quot;Mike Tesla&quot;</code></pre><p><a id="expressions-this-root"></a></p>
<h5 id="this-和-root-变量"><a href="#this-和-root-变量" class="headerlink" title="#this 和 #root 变量"></a><a href="#expressions-this-root"></a><code>#this</code> 和 <code>#root</code> 变量</h5><p><code>#this</code> 变量始终指向当前的对象（处理没有全限定的引用）。<code>#root</code>变量使用指向根上下文对象。尽管<code>#this</code>可能根据表达式而不同。但是，<code>#root</code>一直指向根引用。以下示例显示了如何使用<code>#this</code>和<code>#root</code>变量：</p>
<pre><code>// create an array of integers
List&lt;Integer&gt; primes = new ArrayList&lt;Integer&gt;();
primes.addAll(Arrays.asList(2,3,5,7,11,13,17));

// create parser and set variable &apos;primes&apos; as the array of integers
ExpressionParser parser = new SpelExpressionParser();
EvaluationContext context = SimpleEvaluationContext.forReadOnlyDataAccess();
context.setVariable(&quot;primes&quot;, primes);

// all prime numbers &gt; 10 from the list (using selection ?{...})
// evaluates to [11, 13, 17]
List&lt;Integer&gt; primesGreaterThanTen = (List&lt;Integer&gt;) parser.parseExpression(
        &quot;#primes.?[#this&gt;10]&quot;).getValue(context);</code></pre><p><a id="expressions-ref-functions"></a></p>
<h4 id="4-3-11-函数"><a href="#4-3-11-函数" class="headerlink" title="4.3.11. 函数"></a><a href="#expressions-ref-functions"></a>4.3.11. 函数</h4><p>可以通过用户自定义函数来扩展SpEL，它可以在表达式字符串中使用，函数使用<code>EvaluationContext</code>的方法来注册：</p>
<pre><code>Method method = ...;

EvaluationContext context = SimpleEvaluationContext.forReadOnlyDataBinding().build();
context.setVariable(&quot;myFunction&quot;, method);</code></pre><p>例如，请考虑以下实用程序方法来反转字符串:</p>
<pre><code>public abstract class StringUtils {

    public static String reverseString(String input) {
        StringBuilder backwards = new StringBuilder(input.length());
        for (int i = 0; i &lt; input.length(); i++)
            backwards.append(input.charAt(input.length() - 1 - i));
        }
        return backwards.toString();
    }
}</code></pre><p>然后，您可以注册并使用上述方法，如以下示例所示：</p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();

EvaluationContext context = SimpleEvaluationContext.forReadOnlyDataBinding().build();
context.setVariable(&quot;reverseString&quot;,
        StringUtils.class.getDeclaredMethod(&quot;reverseString&quot;, String.class));

String helloWorldReversed = parser.parseExpression(
        &quot;#reverseString(&apos;hello&apos;)&quot;).getValue(context, String.class);</code></pre><p><a id="expressions-bean-references"></a></p>
<h4 id="4-3-12-Bean的引用"><a href="#4-3-12-Bean的引用" class="headerlink" title="4.3.12. Bean的引用"></a><a href="#expressions-bean-references"></a>4.3.12. Bean的引用</h4><p>如果已使用bean解析器配置了评估上下文，则可以使用<code>@</code> 符号从表达式中查找bean。 以下示例显示了如何执行此操作：</p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();
StandardEvaluationContext context = new StandardEvaluationContext();
context.setBeanResolver(new MyBeanResolver());

// This will end up calling resolve(context,&quot;something&quot;) on MyBeanResolver during evaluation
Object bean = parser.parseExpression(&quot;@something&quot;).getValue(context);</code></pre><p>要访问工厂bean本身,bean名称应改为( <code>&amp;</code>) 前缀符号. The following example shows how to do so:</p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();
StandardEvaluationContext context = new StandardEvaluationContext();
context.setBeanResolver(new MyBeanResolver());

// This will end up calling resolve(context,&quot;&amp;foo&quot;) on MyBeanResolver during evaluation
Object bean = parser.parseExpression(&quot;&amp;foo&quot;).getValue(context);</code></pre><p><a id="expressions-operator-ternary"></a></p>
<h4 id="4-3-13-三元运算符（If-Then-Else）"><a href="#4-3-13-三元运算符（If-Then-Else）" class="headerlink" title="4.3.13. 三元运算符（If-Then-Else）"></a><a href="#expressions-operator-ternary"></a>4.3.13. 三元运算符（If-Then-Else）</h4><p>您可以使用三元运算符在表达式中执行if-then-else条件逻辑。 以下清单显示了一个最小的示例:</p>
<pre><code>String falseString = parser.parseExpression(
        &quot;false ? &apos;trueExp&apos; : &apos;falseExp&apos;&quot;).getValue(String.class);</code></pre><p>在这种情况下，布尔值<code>false</code>会返回字符串值 <code>&#39;falseExp&#39;</code>。 一个更复杂的例子如下：</p>
<pre><code>parser.parseExpression(&quot;Name&quot;).setValue(societyContext, &quot;IEEE&quot;);
societyContext.setVariable(&quot;queryName&quot;, &quot;Nikola Tesla&quot;);

expression = &quot;isMember(#queryName)? #queryName + &apos; is a member of the &apos; &quot; +
        &quot;+ Name + &apos; Society&apos; : #queryName + &apos; is not a member of the &apos; + Name + &apos; Society&apos;&quot;;

String queryResultString = parser.parseExpression(expression)
        .getValue(societyContext, String.class);
// queryResultString = &quot;Nikola Tesla is a member of the IEEE Society&quot;</code></pre><p>有关三元运算符的更短语法，请参阅Elvis运算符的下一节。</p>
<p><a id="expressions-operator-elvis"></a></p>
<h4 id="4-3-14-Elvis运算符"><a href="#4-3-14-Elvis运算符" class="headerlink" title="4.3.14. Elvis运算符"></a><a href="#expressions-operator-elvis"></a>4.3.14. Elvis运算符</h4><p>Elvis运算符是三元运算符语法的缩写，用于<a href="http://www.groovy-lang.org/operators.html#_elvis_operator" target="_blank" rel="noopener">Groovy</a>语言。 使用三元运算符语法，您通常必须重复两次变量，如以下示例所示：</p>
<pre><code>String name = &quot;Elvis Presley&quot;;
String displayName = (name != null ? name : &quot;Unknown&quot;);</code></pre><p>可以使用Elvis运算符来实现，上面例子的也可以使用如下的形式展现：</p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();

String name = parser.parseExpression(&quot;name?:&apos;Unknown&apos;&quot;).getValue(String.class);
System.out.println(name);  // &apos;Unknown&apos;</code></pre><p>以下列表显示了一个更复杂的示例:</p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();
EvaluationContext context = SimpleEvaluationContext.forReadOnlyDataBinding().build();

Inventor tesla = new Inventor(&quot;Nikola Tesla&quot;, &quot;Serbian&quot;);
String name = parser.parseExpression(&quot;Name?:&apos;Elvis Presley&apos;&quot;).getValue(context, tesla, String.class);
System.out.println(name);  // Nikola Tesla

tesla.setName(null);
name = parser.parseExpression(&quot;Name?:&apos;Elvis Presley&apos;&quot;).getValue(context, tesla, String.class);
System.out.println(name);  // Elvis Presley</code></pre><p>您可以使用Elvis运算符在表达式中应用默认值。 以下示例显示如何在<code>@Value</code>表达式中使用Elvis运算符：</p>
<pre><code>@Value(&quot;#{systemProperties[&apos;pop3.port&apos;] ?: 25}&quot;)</code></pre><p>如果已定义，则将注入系统属性<code>pop3.port</code>，否则注入25。</p>
<p><a id="expressions-operator-safe-navigation"></a></p>
<h4 id="4-3-15-安全的引导运算符"><a href="#4-3-15-安全的引导运算符" class="headerlink" title="4.3.15. 安全的引导运算符"></a><a href="#expressions-operator-safe-navigation"></a>4.3.15. 安全的引导运算符</h4><p>安全的引导运算符用于避免<code>NullPointerException</code>异常，这种观念来自<a href="http://www.groovy-lang.org/operators.html#_safe_navigation_operator" target="_blank" rel="noopener">Groovy</a>语言。当需要引用一个对象时， 可能需要在访问对象的方法或属性之前验证它是否为null。为避免出现这种情况， 安全引导运算符将简单地返回null，而不是引发异常。</p>
<pre><code>ExpressionParser parser = new SpelExpressionParser();
EvaluationContext context = SimpleEvaluationContext.forReadOnlyDataBinding().build();

Inventor tesla = new Inventor(&quot;Nikola Tesla&quot;, &quot;Serbian&quot;);
tesla.setPlaceOfBirth(new PlaceOfBirth(&quot;Smiljan&quot;));

String city = parser.parseExpression(&quot;PlaceOfBirth?.City&quot;).getValue(context, tesla, String.class);
System.out.println(city);  // Smiljan

tesla.setPlaceOfBirth(null);
city = parser.parseExpression(&quot;PlaceOfBirth?.City&quot;).getValue(context, tesla, String.class);
System.out.println(city);  // null - does not throw NullPointerException!!!</code></pre><p><a id="expressions-collection-selection"></a></p>
<h4 id="4-3-16-集合的选择"><a href="#4-3-16-集合的选择" class="headerlink" title="4.3.16.集合的选择"></a><a href="#expressions-collection-selection"></a>4.3.16.集合的选择</h4><p>Selection是一种功能强大的表达语言功能，通过从条目中进行选择，可以将某些源集合转换为另一种集合。</p>
<p>Selection使用语法是<code>.?[selectionExpression]</code>. 它会过滤集合并返回一个新的集合，其包含一个原始数据的子集合。例如，Selection可以简单地获取Serbian inventors的list：</p>
<pre><code>List&lt;Inventor&gt; list = (List&lt;Inventor&gt;) parser.parseExpression(
        &quot;Members.?[Nationality == &apos;Serbian&apos;]&quot;).getValue(societyContext);</code></pre><p>Selection可以使用在list和map上。前面的例子中选择独立处理了集合中的元素，而当选择一个map时将会处理每个map的entry（Java类型<code>Map.Entry</code>的对象），Map的entry有他的key和value作为属性访问在Selection中使用。</p>
<p>上述表达式将返回一个新的map，包括原有map中所有值小于27的条目：</p>
<pre><code>Map newMap = parser.parseExpression(&quot;map.?[value&lt;27]&quot;).getValue();</code></pre><p>除了返回所有选定元素外， 还可以只检索第一个或最后一个值。要获得与所选内容匹配的第一个条目语法是 <code>.^[selectionExpression]</code>。而获取最后一个匹配的选择语法是<code>.$[selectionExpression]</code>。</p>
<p><a id="expressions-collection-projection"></a></p>
<h4 id="4-3-17-集合投影"><a href="#4-3-17-集合投影" class="headerlink" title="4.3.17. 集合投影"></a><a href="#expressions-collection-projection"></a>4.3.17. 集合投影</h4><p>投影允许集合被一个子表达式处理而且结果是一个新的集合。投影的语法是<code>.![projectionExpression]</code>。通过例子可便于理解，假设有一个invertors的list并且希望其生产一个叫cities的list， 有效的做法是对每个在invertor的list调用’placeOfBirth.city’。使用投影：</p>
<pre><code>// returns [&apos;Smiljan&apos;, &apos;Idvor&apos; ]
List placesOfBirth = (List)parser.parseExpression(&quot;Members.![placeOfBirth.city]&quot;);</code></pre><p>map可以用于处理投影，在这种情况下投影表达式可以对map中的每个entry进行处理（作为一个Java的 <code>Map.Entry</code>）。map投影的结果是一个list，包含对每一个map条目处理的投影表达式。</p>
<p><a id="expressions-templating"></a></p>
<h4 id="4-3-18-表达式模板"><a href="#4-3-18-表达式模板" class="headerlink" title="4.3.18. 表达式模板"></a><a href="#expressions-templating"></a>4.3.18. 表达式模板</h4><p>表达式模板允许将文字文本与一个或多个评估块混合使用。每个计算块都可以定义的前缀和后缀字符分隔，一般选择使用<code>#{ }</code>作为分隔符。如下例所示：</p>
<pre><code>String randomPhrase = parser.parseExpression(
        &quot;random number is #{T(java.lang.Math).random()}&quot;,
        new TemplateParserContext()).getValue(String.class);

// evaluates to &quot;random number is 0.7038186818312008&quot;</code></pre><p>字符串包含文本<code>&#39;random number is &#39;</code> 和在<code>#{ }</code> 中的表达式的处理结果。这个例子的结果调用了<code>random()</code>方法。第二个参数对于<code>parseExpression()</code>方法是<code>ParserContext</code>的类型。 <code>ParserContext</code>接口可以控制表达式的解释，用于支持表达式模板功能。<code>TemplateParserContext</code> 的定义如下：</p>
<pre><code>public class TemplateParserContext implements ParserContext {

    public String getExpressionPrefix() {
        return &quot;#{&quot;;
    }

    public String getExpressionSuffix() {
        return &quot;}&quot;;
    }

    public boolean isTemplate() {
        return true;
    }
}</code></pre><p><a id="expressions-example-classes"></a></p>
<h3 id="4-4-例子中用到的类"><a href="#4-4-例子中用到的类" class="headerlink" title="4.4. 例子中用到的类"></a><a href="#expressions-example-classes"></a>4.4. 例子中用到的类</h3><p>本节列出了本章示例中使用的类。</p>
<p>Example 1. Inventor.java</p>
<pre><code>package org.spring.samples.spel.inventor;

import java.util.Date;
import java.util.GregorianCalendar;

public class Inventor {

    private String name;
    private String nationality;
    private String[] inventions;
    private Date birthdate;
    private PlaceOfBirth placeOfBirth;

    public Inventor(String name, String nationality) {
        GregorianCalendar c= new GregorianCalendar();
        this.name = name;
        this.nationality = nationality;
        this.birthdate = c.getTime();
    }

    public Inventor(String name, Date birthdate, String nationality) {
        this.name = name;
        this.nationality = nationality;
        this.birthdate = birthdate;
    }

    public Inventor() {
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getNationality() {
        return nationality;
    }

    public void setNationality(String nationality) {
        this.nationality = nationality;
    }

    public Date getBirthdate() {
        return birthdate;
    }

    public void setBirthdate(Date birthdate) {
        this.birthdate = birthdate;
    }

    public PlaceOfBirth getPlaceOfBirth() {
        return placeOfBirth;
    }

    public void setPlaceOfBirth(PlaceOfBirth placeOfBirth) {
        this.placeOfBirth = placeOfBirth;
    }

    public void setInventions(String[] inventions) {
        this.inventions = inventions;
    }

    public String[] getInventions() {
        return inventions;
    }
}</code></pre><p>Example 2. PlaceOfBirth.java</p>
<pre><code>package org.spring.samples.spel.inventor;

public class PlaceOfBirth {

    private String city;
    private String country;

    public PlaceOfBirth(String city) {
        this.city=city;
    }

    public PlaceOfBirth(String city, String country) {
        this(city);
        this.country = country;
    }

    public String getCity() {
        return city;
    }

    public void setCity(String s) {
        this.city = s;
    }

    public String getCountry() {
        return country;
    }

    public void setCountry(String country) {
        this.country = country;
    }

}</code></pre><p>Example 3. Society.java</p>
<pre><code>package org.spring.samples.spel.inventor;

import java.util.*;

public class Society {

    private String name;

    public static String Advisors = &quot;advisors&quot;;
    public static String President = &quot;president&quot;;

    private List&lt;Inventor&gt; members = new ArrayList&lt;Inventor&gt;();
    private Map officers = new HashMap();

    public List getMembers() {
        return members;
    }

    public Map getOfficers() {
        return officers;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public boolean isMember(String name) {
        for (Inventor inventor : members) {
            if (inventor.getName().equals(name)) {
                return true;
            }
        }
        return false;
    }

}</code></pre> 
      <!-- reward -->
      
      <div id="reword-out">
        <div id="reward-btn">
          打赏
        </div>
      </div>
      
    </div>
    

    <!-- copyright -->
    
    <footer class="article-footer">
       
<div class="share-btn">
      <span class="share-sns share-outer">
        <i class="ri-share-forward-line"></i>
        分享
      </span>
      <div class="share-wrap">
        <i class="arrow"></i>
        <div class="share-icons">
          
          <a class="weibo share-sns" href="javascript:;" data-type="weibo">
            <i class="ri-weibo-fill"></i>
          </a>
          <a class="weixin share-sns wxFab" href="javascript:;" data-type="weixin">
            <i class="ri-wechat-fill"></i>
          </a>
          <a class="qq share-sns" href="javascript:;" data-type="qq">
            <i class="ri-qq-fill"></i>
          </a>
          <a class="douban share-sns" href="javascript:;" data-type="douban">
            <i class="ri-douban-line"></i>
          </a>
          <!-- <a class="qzone share-sns" href="javascript:;" data-type="qzone">
            <i class="icon icon-qzone"></i>
          </a> -->
          
          <a class="facebook share-sns" href="javascript:;" data-type="facebook">
            <i class="ri-facebook-circle-fill"></i>
          </a>
          <a class="twitter share-sns" href="javascript:;" data-type="twitter">
            <i class="ri-twitter-fill"></i>
          </a>
          <a class="google share-sns" href="javascript:;" data-type="google">
            <i class="ri-google-fill"></i>
          </a>
        </div>
      </div>
</div>

<div class="wx-share-modal">
    <a class="modal-close" href="javascript:;"><i class="ri-close-circle-line"></i></a>
    <p>扫一扫，分享到微信</p>
    <div class="wx-qrcode">
      <img src="//api.qrserver.com/v1/create-qr-code/?size=150x150&data=https://dxysun.com/2020/12/13/springForSpel/" alt="微信分享二维码">
    </div>
</div>

<div id="share-mask"></div>  
  <ul class="article-tag-list" itemprop="keywords"><li class="article-tag-list-item"><a class="article-tag-list-link" href="/tags/spring/" rel="tag">spring</a></li></ul>

    </footer>
  </div>

   
  <nav class="article-nav">
    
      <a href="/2020/12/13/springForAop/" class="article-nav-link">
        <strong class="article-nav-caption">上一篇</strong>
        <div class="article-nav-title">
          
            5、Spring面向切面编程
          
        </div>
      </a>
    
    
      <a href="/2020/12/13/springForvalidator/" class="article-nav-link">
        <strong class="article-nav-caption">下一篇</strong>
        <div class="article-nav-title">3、Spring 数据验证</div>
      </a>
    
  </nav>

  
   
  
</article>

</section>
      <footer class="footer">
  <div class="outer">
    <ul>
      <li>
        Copyrights &copy;
        2015-2024
        <i class="ri-heart-fill heart_icon"></i> dxysun
      </li>
    </ul>
    <ul>
      <li>
        
        
        
        由 <a href="https://hexo.io" target="_blank">Hexo</a> 强力驱动
        <span class="division">|</span>
        主题 - <a href="https://github.com/Shen-Yu/hexo-theme-ayer" target="_blank">Ayer</a>
        
      </li>
    </ul>
    <ul>
      <li>
        
        
        <span>
  <span><i class="ri-user-3-fill"></i>访问人数:<span id="busuanzi_value_site_uv"></span></s>
  <span class="division">|</span>
  <span><i class="ri-eye-fill"></i>浏览次数:<span id="busuanzi_value_page_pv"></span></span>
</span>
        
      </li>
    </ul>
    <ul>
      
        <li>
          <a href="https://beian.miit.gov.cn" target="_black" rel="nofollow">豫ICP备17012675号-1</a>
        </li>
        
    </ul>
    <ul>
      
    </ul>
    <ul>
      <li>
        <!-- cnzz统计 -->
        
      </li>
    </ul>
  </div>
</footer>
      <div class="float_btns">
        <div class="totop" id="totop">
  <i class="ri-arrow-up-line"></i>
</div>

<div class="todark" id="todark">
  <i class="ri-moon-line"></i>
</div>

      </div>
    </main>
    <aside class="sidebar on">
      <button class="navbar-toggle"></button>
<nav class="navbar">
  
  <div class="logo">
    <a href="/"><img src="https://dxysun.com/static/logo.png" alt="迎着朝阳"></a>
  </div>
  
  <ul class="nav nav-main">
    
    <li class="nav-item">
      <a class="nav-item-link" href="/">主页</a>
    </li>
    
    <li class="nav-item">
      <a class="nav-item-link" href="/archives">归档</a>
    </li>
    
    <li class="nav-item">
      <a class="nav-item-link" href="/categories">分类</a>
    </li>
    
    <li class="nav-item">
      <a class="nav-item-link" href="/tags">标签</a>
    </li>
    
    <li class="nav-item">
      <a class="nav-item-link" href="/photos">相册</a>
    </li>
    
    <li class="nav-item">
      <a class="nav-item-link" href="/friends">友链</a>
    </li>
    
    <li class="nav-item">
      <a class="nav-item-link" href="/about">关于我</a>
    </li>
    
  </ul>
</nav>
<nav class="navbar navbar-bottom">
  <ul class="nav">
    <li class="nav-item">
      
      <a class="nav-item-link nav-item-search"  title="搜索">
        <i class="ri-search-line"></i>
      </a>
      
      
      <a class="nav-item-link" target="_blank" href="/atom.xml" title="RSS Feed">
        <i class="ri-rss-line"></i>
      </a>
      
    </li>
  </ul>
</nav>
<div class="search-form-wrap">
  <div class="local-search local-search-plugin">
  <input type="search" id="local-search-input" class="local-search-input" placeholder="Search...">
  <div id="local-search-result" class="local-search-result"></div>
</div>
</div>
    </aside>
    <script>
      if (window.matchMedia("(max-width: 768px)").matches) {
        document.querySelector('.content').classList.remove('on');
        document.querySelector('.sidebar').classList.remove('on');
      }
    </script>
    <div id="mask"></div>

<!-- #reward -->
<div id="reward">
  <span class="close"><i class="ri-close-line"></i></span>
  <p class="reward-p"><i class="ri-cup-line"></i>请我喝杯咖啡吧~</p>
  <div class="reward-box">
    
    <div class="reward-item">
      <img class="reward-img" src="https://tu.dxysun.com/alipay-20201219151322.jpg">
      <span class="reward-type">支付宝</span>
    </div>
    
    
    <div class="reward-item">
      <img class="reward-img" src="https://tu.dxysun.com/weixin-20201219151346.png">
      <span class="reward-type">微信</span>
    </div>
    
  </div>
</div>
    
<script src="/js/jquery-2.0.3.min.js"></script>


<script src="/js/lazyload.min.js"></script>

<!-- Tocbot -->


<script src="/js/tocbot.min.js"></script>

<script>
  tocbot.init({
    tocSelector: '.tocbot',
    contentSelector: '.article-entry',
    headingSelector: 'h1, h2, h3, h4, h5, h6',
    hasInnerContainers: true,
    scrollSmooth: true,
    scrollContainer: 'main',
    positionFixedSelector: '.tocbot',
    positionFixedClass: 'is-position-fixed',
    fixedSidebarOffset: 'auto'
  });
</script>

<script src="https://cdn.jsdelivr.net/npm/jquery-modal@0.9.2/jquery.modal.min.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/jquery-modal@0.9.2/jquery.modal.min.css">
<script src="https://cdn.jsdelivr.net/npm/justifiedGallery@3.7.0/dist/js/jquery.justifiedGallery.min.js"></script>

<script src="/dist/main.js"></script>

<!-- ImageViewer -->

<!-- Root element of PhotoSwipe. Must have class pswp. -->
<div class="pswp" tabindex="-1" role="dialog" aria-hidden="true">

    <!-- Background of PhotoSwipe. 
         It's a separate element as animating opacity is faster than rgba(). -->
    <div class="pswp__bg"></div>

    <!-- Slides wrapper with overflow:hidden. -->
    <div class="pswp__scroll-wrap">

        <!-- Container that holds slides. 
            PhotoSwipe keeps only 3 of them in the DOM to save memory.
            Don't modify these 3 pswp__item elements, data is added later on. -->
        <div class="pswp__container">
            <div class="pswp__item"></div>
            <div class="pswp__item"></div>
            <div class="pswp__item"></div>
        </div>

        <!-- Default (PhotoSwipeUI_Default) interface on top of sliding area. Can be changed. -->
        <div class="pswp__ui pswp__ui--hidden">

            <div class="pswp__top-bar">

                <!--  Controls are self-explanatory. Order can be changed. -->

                <div class="pswp__counter"></div>

                <button class="pswp__button pswp__button--close" title="Close (Esc)"></button>

                <button class="pswp__button pswp__button--share" style="display:none" title="Share"></button>

                <button class="pswp__button pswp__button--fs" title="Toggle fullscreen"></button>

                <button class="pswp__button pswp__button--zoom" title="Zoom in/out"></button>

                <!-- Preloader demo http://codepen.io/dimsemenov/pen/yyBWoR -->
                <!-- element will get class pswp__preloader--active when preloader is running -->
                <div class="pswp__preloader">
                    <div class="pswp__preloader__icn">
                        <div class="pswp__preloader__cut">
                            <div class="pswp__preloader__donut"></div>
                        </div>
                    </div>
                </div>
            </div>

            <div class="pswp__share-modal pswp__share-modal--hidden pswp__single-tap">
                <div class="pswp__share-tooltip"></div>
            </div>

            <button class="pswp__button pswp__button--arrow--left" title="Previous (arrow left)">
            </button>

            <button class="pswp__button pswp__button--arrow--right" title="Next (arrow right)">
            </button>

            <div class="pswp__caption">
                <div class="pswp__caption__center"></div>
            </div>

        </div>

    </div>

</div>

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/photoswipe@4.1.3/dist/photoswipe.min.css">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/photoswipe@4.1.3/dist/default-skin/default-skin.min.css">
<script src="https://cdn.jsdelivr.net/npm/photoswipe@4.1.3/dist/photoswipe.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/photoswipe@4.1.3/dist/photoswipe-ui-default.min.js"></script>

<script>
    function viewer_init() {
        let pswpElement = document.querySelectorAll('.pswp')[0];
        let $imgArr = document.querySelectorAll(('.article-entry img:not(.reward-img)'))

        $imgArr.forEach(($em, i) => {
            $em.onclick = () => {
                // slider展开状态
                // todo: 这样不好，后面改成状态
                if (document.querySelector('.left-col.show')) return
                let items = []
                $imgArr.forEach(($em2, i2) => {
                    let img = $em2.getAttribute('data-idx', i2)
                    let src = $em2.getAttribute('data-target') || $em2.getAttribute('src')
                    let title = $em2.getAttribute('alt')
                    // 获得原图尺寸
                    const image = new Image()
                    image.src = src
                    items.push({
                        src: src,
                        w: image.width || $em2.width,
                        h: image.height || $em2.height,
                        title: title
                    })
                })
                var gallery = new PhotoSwipe(pswpElement, PhotoSwipeUI_Default, items, {
                    index: parseInt(i)
                });
                gallery.init()
            }
        })
    }
    viewer_init()
</script>

<!-- MathJax -->

<script type="text/x-mathjax-config">
  MathJax.Hub.Config({
      tex2jax: {
          inlineMath: [ ['$','$'], ["\\(","\\)"]  ],
          processEscapes: true,
          skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code']
      }
  });

  MathJax.Hub.Queue(function() {
      var all = MathJax.Hub.getAllJax(), i;
      for(i=0; i < all.length; i += 1) {
          all[i].SourceElement().parentNode.className += ' has-jax';
      }
  });
</script>

<script src="https://cdn.jsdelivr.net/npm/mathjax@2.7.6/unpacked/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script>
  var ayerConfig = {
    mathjax: true
  }
</script>

<!-- Katex -->

<!-- busuanzi  -->


<script src="/js/busuanzi-2.3.pure.min.js"></script>


<!-- ClickLove -->

<!-- ClickBoom1 -->

<!-- ClickBoom2 -->

<!-- CodeCopy -->


<link rel="stylesheet" href="/css/clipboard.css">

<script src="https://cdn.jsdelivr.net/npm/clipboard@2/dist/clipboard.min.js"></script>
<script>
  function wait(callback, seconds) {
    var timelag = null;
    timelag = window.setTimeout(callback, seconds);
  }
  !function (e, t, a) {
    var initCopyCode = function(){
      var copyHtml = '';
      copyHtml += '<button class="btn-copy" data-clipboard-snippet="">';
      copyHtml += '<i class="ri-file-copy-2-line"></i><span>COPY</span>';
      copyHtml += '</button>';
      $(".highlight .code pre").before(copyHtml);
      $(".article pre code").before(copyHtml);
      var clipboard = new ClipboardJS('.btn-copy', {
        target: function(trigger) {
          return trigger.nextElementSibling;
        }
      });
      clipboard.on('success', function(e) {
        let $btn = $(e.trigger);
        $btn.addClass('copied');
        let $icon = $($btn.find('i'));
        $icon.removeClass('ri-file-copy-2-line');
        $icon.addClass('ri-checkbox-circle-line');
        let $span = $($btn.find('span'));
        $span[0].innerText = 'COPIED';
        
        wait(function () { // 等待两秒钟后恢复
          $icon.removeClass('ri-checkbox-circle-line');
          $icon.addClass('ri-file-copy-2-line');
          $span[0].innerText = 'COPY';
        }, 2000);
      });
      clipboard.on('error', function(e) {
        e.clearSelection();
        let $btn = $(e.trigger);
        $btn.addClass('copy-failed');
        let $icon = $($btn.find('i'));
        $icon.removeClass('ri-file-copy-2-line');
        $icon.addClass('ri-time-line');
        let $span = $($btn.find('span'));
        $span[0].innerText = 'COPY FAILED';
        
        wait(function () { // 等待两秒钟后恢复
          $icon.removeClass('ri-time-line');
          $icon.addClass('ri-file-copy-2-line');
          $span[0].innerText = 'COPY';
        }, 2000);
      });
    }
    initCopyCode();
  }(window, document);
</script>


<!-- CanvasBackground -->


<script src="/js/dz.js"></script>



    
  </div>
</body>

</html>